Skip to content

Add Office Hotkeys plugin - #693

Closed
pjleduc wants to merge 3 commits into
fatihak:mainfrom
pjleduc:add-office-hotkeys-plugin
Closed

Add Office Hotkeys plugin#693
pjleduc wants to merge 3 commits into
fatihak:mainfrom
pjleduc:add-office-hotkeys-plugin

Conversation

@pjleduc

@pjleduc pjleduc commented May 21, 2026

Copy link
Copy Markdown

Office Hotkeys plugin

A new plugin that displays a keyboard-shortcut cheat sheet for Microsoft Excel, Outlook, and PowerPoint — a glanceable, rotating reference for the e-ink display.

What it does

  • Per-instance settings: App (Excel / Outlook / PowerPoint) and Skill level (Beginner / Intermediate / Advanced).
  • Each refresh shows one themed category of shortcuts (Navigation, Formatting, Formulas & Functions, …), rotating hourly so the display stays fresh.
  • Skill level is a difficulty floor — it shows shortcuts at your level and harder, topping up with the next level down only when a category is thin, so an Advanced screen stays advanced-first and never shows trivial shortcuts.
  • Weighted-random selection picks a highlighted "top move" plus a list of shortcuts; content reshuffles each refresh.
  • Bundled, curated Windows-shortcut dataset (data/shortcuts.json) — no external API or network access required.

Implementation

  • Follows docs/building_plugins.md: OfficeHotkeys(BasePlugin) with generate_image / generate_settings_template, render/ HTML + CSS via render_image, plus settings.html, icon.png, and plugin-info.json.
  • The selection logic (selection.py, constants.py) is pure and stdlib-only, kept separate from rendering, with pytest unit tests in tests/.
  • Designed for the 6-colour Spectra e-ink palette — flat, high-contrast.

Testing

  • Unit tests cover category rotation, the skill-level floor + top-up, and weighted selection.
  • Verified on hardware — Raspberry Pi Zero 2 W with an Inky Impression 7.3" (800×480) — rendering correctly for all three apps across skill levels.

🤖 Generated with Claude Code

pjleduc and others added 3 commits May 21, 2026 14:10
A plugin that displays a rotating keyboard-shortcut cheat sheet for
Excel, Outlook, and PowerPoint, with a per-instance app and skill-level
filter. Pure selection logic with unit tests; renders via HTML/CSS.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Switch the shortcut list from a 2-column grid to a single column with
much larger text, showing 6 items instead of 8. The 2-column layout
packed in more shortcuts but the text was too small to read on the
e-ink panel.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Reduce to one hero plus 4 list items so each line can be considerably
larger, improving readability on the e-ink panel.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@phattmatt

Copy link
Copy Markdown
Collaborator

Hi @pjleduc,

Thanks for the contribution, I can see people getting some great use out of this.

InkyPi has introduced support for 3rd party plugin installs and as such will probably not accept new plugins into the core project:

https://github.com/fatihak/InkyPi/blob/main/docs/building_plugins.md#publishing-a-third-party-plugin

https://github.com/fatihak/InkyPi/wiki/3rd-Party-Plugins

I hope you consider re-working your plugin and publishing it that way.

In the meantime I will close this PR, feel free to re-open, or open a new one if you feel this has been closed in error.

@phattmatt phattmatt closed this Aug 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants